home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 4 / CU Amiga Magazine's Super CD-ROM 04 (1996)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1996-11].iso / magazine / psion / utils / jpcli161.lzx / jpcli.wrd (.txt) < prev   
Psion Series 3 Word Document  |  1979-09-01  |  35KB  |  762 lines

  1. PSIONWPDATAFILE
  2. ROM::BJ.WDR
  3. BTBody text
  4.      
  5. HAHeading A
  6.      
  7. HBHeading B
  8.      
  9. BLBulleted list
  10. y text
  11.      
  12. y text
  13.      
  14. HCHeader c
  15.      
  16. NNNormal
  17.         
  18. UUUnderline
  19.      
  20. BBBold
  21.           
  22. IIItalic
  23.         
  24. EESuperscript
  25. SSSubscript
  26.      
  27.  vJPcli v1.61
  28. A command line interface for the Psion 3a
  29. By John Portwin
  30. * What is JPcli?
  31.     JPcli is, basically, an MS-DOS emulator for the Psion 3a. You will find that lots of the commands of MS-DOS are available, as well as many more.
  32. See later in this file for a command by command list.
  33.     So why would you want to turn your multitasking, GUI based Psion into a single process, CLI (i.e. user unfriendly) machine? There are a number of reasons. Firstly, it is much quicker. There are also a lot of more advanced commands available (do you see an encryption facility in the system screen?). You can easily run a number of applications from the command line - such as Word, Agenda - in fact, all of the internal applications, including Script and Comms - and you can also run OPA, OPO and APP files. Other powerful commands are available - the encoding program already mentioned, a facility to copy files over from the ROM:: device (such as the internal applications!), ability to play .WVE files and dial telephone numbers, full online help, full compatibility with MS-DOS filing systems, ability to view PIC files, a string search facility, binary file views and editing, file type identification, seamless interfacing with your own type 2+ apps, complete battery checking facilities, sound setting control, and much, much more!
  34. * What files should I have?
  35.     If you have the internal help version, you should have the following files:
  36.     JPCLI.OPA         - JPcli main program
  37.     JPCLI.WRD        - This file
  38.     JPCLI.TXT        - This file in .TXT (ASCII) format
  39.     JPPRINT.OPL    - A background print spooler (An example on using JPcli
  40.                    dropfiles!)
  41.     FILE_ID.DIZ    - Description file
  42.     If you have the external help version:
  43.     JPCLI.OPA        - JPcli main program
  44.     JPCLI.WRD        - This file
  45.     JPCLI.TXT        - This file in .TXT (ASCII) format
  46.     JPPRINT.OPL    - A background print spooler (An example on using JPcli
  47.                    dropfiles!)
  48.     FILE_ID.DIZ    - Description file
  49.     JPCLI.HLP        - Help file
  50. * So how do I install this wonderful program?
  51.     Simple. Just make a directory on your LOC::M: drive called JPCLI, and copy JPCLI.OPA into it. Then go to the system screen and press PSION-I - change to the M:\JPCLI directory and select JPCLI.OPA. If you have the external help version, copy JPCLI.HLP into the \JPCLI directory as well. This file can be deleted and JPCLI will still run (with more limited help!)
  52. * OK, Now what do I do?
  53.     Select the JPcli icon (the picture of a Psion 3a with JPcli on the screen - sorry, but I'm not a particularly good .PIC file artist) and press enter. The JPcli welcome screen will come up and ask you for your name. Enter your name as you would like it to be when you register (if you register - WHICH YOU WILL!!). You will be asked to confirm. JPcli will then exit. (Don't worry - it will be back in a minute).
  54. * Now what?
  55.     Once again, run JPcli. It will display some blurb about registering and then display a single M:\> prompt, which as MS-DOS fanatics will know means that you are in the root (\) directory of drive M:. JPcli is now waiting for you to input commands.
  56.     Of course, I hope you know how to use MS-DOS - this program isn't going to be much use to you if you don't!
  57.     Each time JPcli loads, it checks your internal battery, backup battery, and then checks A: and B: for RAM SSDs and, if it finds any, checks their batteries as well. This is dependant on the semaphore NOBATT.SEM not existing (see later).
  58. * Help!!
  59.     A brief summary of all the available commands is accessible by entering HELP, or by pressing the HELP key and pressing enter. If you have the internal help version, or the external version with JPCI.HLP, full help for each command is available by typing HELP <commandname> where <commandname> is the name of the command you want help on (duh...). If you have the external help version of JPcli and don't have JPCLI.HLP, only a brief summary of commands is available.
  60. * Preamble by the author
  61.     I wrote JPcli in about 4 months of on-and-off work. I'm 15, and spend far too much time in lessons and at home writing this program. ;)
  62.     The source code for JPcli is huge - over  3,838 lines of OPL, roughly 73 pages of A4. There aren't any major bugs, and expect more updates soon. Probably. :)
  63.     If you don't like the manual, blame me. Never ask the programmer to write the manuals. (any offers??)
  64.     Thanks to the Beta testers:
  65.     Matthew Horsnell
  66.     Kenneth Wright
  67.     Neil Worton
  68.     and the others...
  69.     With special thanks to Ken Wright - who supplied me with the source code when I accidentally deleted it. I am forever in your debt!!
  70. * Artificial Intelligence?
  71.     JPcli is a very intelligent program. It will automatically detect the date format and time format that is set in the time application, as well as the separators and the am/pm format. It will also check your batteries each time you start off. It will resize the cache it uses depending upon the amount of memory free. And it knows how long it has been unregistered!
  72. * Warranty and technical support
  73.     There is no warranty. If JPcli wipes your internal disk, blows up your speaker, destroys your screen, crashes, causes world war III, or whatever, I am not to be held responsible (although I'd appreciate knowing about it!)
  74.     Any questions? Email me at john@lyster.demon.co.uk, or netmail me (John Portwin) at 2:252/337@fidonet or 405:110/7@bbsnet.
  75. * What can I do, anyway?
  76.     The following commands are available:
  77. ATTRIB (file) [one of -r +r -h +h -s +s -m +m]
  78.     Sets file attributes (read only, system, hidden, modified)
  79.     Sends JPcli to the background. Press CTRL-Z to bring it back.
  80.     Shows battery power levels. 
  81.     Show current directory.
  82. CD (directory)
  83.     Change to specified directory.
  84. CFILE (filename)
  85.     Load the SLE (single line editor) and create the specified file. See later.
  86. CHARMAP
  87.     Displays a character map.
  88.     Clear screen. If the /G optional switch is used, the screen is cleared but the
  89.     current position remains unchanged.
  90. CRASH
  91.     Emergency stop!
  92. COMPARE (file 1) (file 2)
  93.     Sees if the two specified files are indentical, and if not, shows where and what the
  94.     differences are.
  95. COMPRESS (file)
  96.     Compresses the specified data (.DBF) file.
  97. COPY (file 1) (file 2/directory)
  98.     Copies file 1 to file 2 or to the specified directory. If you specify a directory it
  99.     must have an \ on the end i.e. \APP\.
  100. CURDEF
  101.     View current JPcli settings.
  102. CURPROC
  103.     Sees which processes are currently running
  104. DATE 
  105.     Shows the current date
  106. DECODE (file) (file-to-write)
  107.     Decodes the specfied file and asks for the two encryption keys. This command only
  108.     decodes RUF (Rotary Unit Fixing) files.
  109. DELETE (file)
  110. DEL (file)
  111. ERASE (file)
  112.     Erases the specified file.
  113. DIAL (number)
  114.     Dials the given telephone number. (Sound must be on). The number may consist of
  115.     the following: (0123456789ABCDEF#*)
  116. DINFO
  117.     Displays information about the current drive.
  118. DINFO (device)(drive)
  119.     Displays information about the specified drive and/or device.
  120.     Shows a listing of files in current directory. See later in the manual.
  121.     Exits to DOS (only if you are running on the PC emulator) - WARNING - you will lose
  122.     all unsaved data in all applications.
  123. EDIT (file)
  124.     Loads the word processor in text mode, editing the specified file.
  125. ENCODE (file) (file-to-write)
  126.     Encodes a file using the Rotary Unit Fixing (RUF) method. You will be asked for two
  127.     encoding keys. Don't forget them! See later in the manual.
  128. ENVINFO
  129.     Dislays misc. s3a user defaults.
  130. EVAL (string)
  131.     Evaluates the specified string.
  132.     Returns to the System screen. Optional switch /B does the same as the command
  133.     BACK.
  134. FINFO [filing system]
  135.     Shows information about the specified filing system (default is the current)
  136. FONT (font)
  137.     Sets the font used by JPcli. The font can be any of the internal fonts or one
  138.     loaded by LOADF.
  139. GETENV
  140.     Shows what the environment variables are set to.
  141. GETFTYPE (filename)
  142.     Makes JPcli says what it thinks the file format is.
  143. GETLANG
  144.     Shows the language your s3a is set to.
  145. GETUSER
  146.     Shows who JPcli is registered (or not registered) to.
  147.     Shows brief help.
  148. HELP (command)
  149.     Shows help on a command.
  150. KILL (Process ID)
  151.     Kills the specified process. See later for details.
  152. LOADF (font name)
  153.     Loads the font specified and returns the font number to use with FONT.
  154. LOADM (.OPO file)
  155.     Loads an .OPO file into memory. A maximum of three can be loaded at any one time.
  156.     (Two with the external help version). The loaded procedures in the file can be
  157.     run with RP.
  158. LOC::
  159.     Change to the local filing system - this will change to the M:\ directory.
  160. MCOPY (file 1) (file 2)
  161.     Copies file 1 to file 2, however, this appends files (if file 2 already exists,
  162.     file 1 will be added after the existing code)
  163. MD (directory)
  164.     Makes a directory with the given name.
  165. MEM [/c]
  166.     Sees how much memory is available (/c switch sees which processes are running)
  167. MOVE (filename) (directory to move to)
  168.     Moves a file to another location
  169. NEWSIZE (filename) (new size in bytes)
  170.     Changes the specified file's size to the new size.
  171. OFF [time]
  172.     Turns the s3a off, optionally for the specifed time.
  173.     Shows the current path
  174. PATH (path)
  175.     Sets the path to the specified one.
  176. PAUSE
  177.     Pauses JPcli and waits for a keypress.
  178. PINFO (Process ID)
  179.     Shows information on the specified process.
  180. PRINTF (file)
  181.     Prints the specified file to another file.
  182. PRINTP (file)
  183.     Prints the specified file to the parallel port.
  184. PRINTS (file)
  185.     Prints the specified file to the serial port.
  186. PROMPT
  187.     Shows the current prompt.
  188. PROMPT (prompt)
  189.     Sets the prompt.
  190. RD (directory name)
  191.     Removes a directory.
  192. REM::
  193.     Changes to an external filing system and returns to the  \ directory.
  194. RENAME (file 1) (file 2)
  195.     Renames file 1 to file 2. File 2 must not already exist. You can also rename
  196.     directories with this command.
  197. ROM::
  198.     Change to s3a internal ROM - you cannot change drive or path.
  199.     Runs a procedure previously loaded in a module loaded with LOADM. Don't put a :
  200.     after the procedure name.
  201. RUNAPP (app) (file)
  202.     Runs another application (app) using the specified file (file). See later in the
  203.     manual for this.
  204. RUNJPC (.JPC file)
  205.     Run a .JPC batch file. See later in the manual.
  206.     Shows help on setting JPcli default.
  207. SET [default=value]
  208.     Lets you set JPcli defaults. 
  209. SSEARCH (filename) (string to find)
  210.     Searches the filename specified for the specified string, and gives offset 
  211.     positions for occurences.
  212. SINFO
  213.     Shows the current sound settings.
  214. SSOUND (any of +KL +KS -K +P -P +S -S +O -O)
  215.     Sets the sound settings. See later.
  216. STATUSWIN [on/off/small]
  217.     Sets the status window to the specified size.
  218. STYLE (style)
  219.     Sets the text style to use.
  220. SWOFF (time)
  221.     Sets the auto-off timer. Time should be in seconds, or OFF to disable
  222.     auto-switch-off.
  223. SWOFFM (ON/OFF)
  224.     Turns on/off switchoff if external power is present.
  225. SYSINFO
  226.     Displays system info.
  227.     Shows the current time.
  228. TYPE (text file)
  229.     Views a file (text mode)
  230. ULOADF (font number)
  231.     Unloads a font previously loaded with LOADF.
  232. ULOADM (name)
  233.      Unloads an .OPO module previously loded with LOADM.
  234.     Displays the current version of JPcli.
  235. VFILE (file)
  236.     Views a file (binary mode/byte-by-byte)
  237. VPIC (file)
  238.     Views a .PIC file.
  239. VPICG (file)
  240.     Views a .PIC file in grey mode.
  241. WAIT (time)
  242.     Pauses JPcli for the specified time.
  243. WPLAY (full path+.WVE file)
  244.     Plays a .WVE file (sound must be on).
  245. More help is available in JPcli by typing HELP (command)..
  246. * DIR (Directory)
  247.     The DIR command in JPcli is quite easy to use - just type DIR and a listing of the files in the current directory, along with sizes, flags, and date of last modification.
  248. To only view certain files, type DIR (filespec), ie DIR *.JPC would list only .JPC files, etc.
  249. Here is an example dir listing:
  250. JPCLI.OPA   22775        -R-S-M        08:43:50 09/03/95
  251. This shows the file JPCLI.OPA is 22775 bytes long, is read only (R), a system file (S), has been modified (M), and was last changed at 8:43am on the 9th March '95.
  252. The flags are as follows:
  253. D - Shows that the entry is a directory
  254. R - Shows the file is read only
  255. H - Shows the file is hidden
  256. S - Shows the file is a system file
  257. V - The file is a volume label (PC/DOS only)
  258. M - Shows the file has been modified since it was first written.
  259. DIR can have five optional switches:
  260. /1 - Formats list to 1 column (default)
  261. /2 - Formats list to 2 columns 
  262. /W - Formats list to widescreen format
  263. /G - Shows first 16 bytes of each file
  264. /T - Makes JPcli ID each file (like GETFTYPE)
  265. The default format can be set with the SET DIRCMD command.
  266. * Keys to press
  267.     In many places you can either press ESC or Control-C to stop commands continuing (like DIR, VFILE, TYPE etc). If you want to temporarily halt screen output, press Control-S to pause the screen and then press a key to resume. You can also press Control-Shift-Psion-s together to save \SCREEN.PIC, a copy of the current screen. Registered versions of JPcli can also quick exit by pressing Psion-ESC.
  268. * The ROM:: device
  269.     Using JPcli, you can see all the files that are on the s3a's internal rom. Simply change to the ROM device (enter ROM:: and press enter). All of the internal apps are there - WORD.APP, AGENDA.APP, DATA.APP - as well as some .WVE and .FON files. You can grab a copy of some of these files with the COPY command.
  270. * Setting sound
  271.     The SSOUND command is very similar to the Psion-S command from the system screen.
  272. The optional parameters are:
  273. +KL Sets loud key clicks
  274. +KS Sets soft key clicks
  275. -K Turns off key clicks
  276. +P Sets piezo buzzer on
  277. -P Turns it off
  278. +S Sets loudspeaker on
  279. -S Turns it off
  280. +O All sound on (obey individual flags)
  281. -O All sound off
  282. Prefix each parameter with a + to turn it on, and a - to turn it off. JPcli will ignore a parameter if it is already set.
  283. * Cache tradeoffs
  284.     If you want to use the cache, JPcli runs faster, but uses *lots* more memory (almost twice as much). If you don't want to, use the appropriate semaphore file.
  285. * Killing apps
  286.     Although this is a useful command, it can cause problems. Firstly, make sure that
  287. the application has saved all its data. And it is very important that you do not kill SYS$WSRV.$04 - if you do, your s3a will lock up and crash, and you will have to reset it or leave it for five minutes (after which time it will reset itself). Also, if you kill SYS$SHLL.$05, it will appear as if your s3a has reset, but it hasn't really - only the System screen will have exited, so you lose the icons of installed applications, but just re-install them and they will still be running. In theory. :) There don't seem to be any drawbacks to killing the Time app - you will, however, lose any alarms that are set.
  288. * The PATH command
  289.     Using the path command, you can give JPcli a list of directories to search for valid files. A path must contain a list of directories, each separated by a ;
  290. This is what a valid path may look like:
  291. PATH \;\APP\;\OPO\;\JPCLI\;
  292. The path can be up to 128 characters long. A long path can really slow JPcli down.
  293. To clear the path, type PATH CLEAR or PATH OFF.
  294. * The PROMPT command
  295.     The default M:\> prompt can be changed to suit your needs. Simply set the prompt, using the PROMPT command, as follows:
  296. PROMPT (new prompt).
  297.     The new prompt can be whatever you like - there are some shortcuts that can be intermingled with the text:
  298. $P - Drive and Path
  299. $F - Filing System
  300. $D - Drive
  301. $I - Path
  302. $G - >
  303. $$ - Dollar sign
  304. $T - Time (24hr format)
  305. $A - Date
  306. $* - Carriage return
  307. $M - Memory free
  308. $W - Day of week
  309. $V - Version of JPcli
  310. * The SLE (Single Line Editor)
  311.     The single line editor provides an easy way to create your own textfiles. To use it, just type CFILE (filename). Then, enter the data as normal, pressing enter at the end of each line. If you make a mistake, press Delete. When you have finished, press ESC. Any existing file with the same name will be deleted.
  312. * COM.DAT
  313.     The COM.DAT provides an easy way of getting JPcli and other JP applications (like JPprint, the background print spooler) - to run your serial port correctly.
  314. If COM.DAT exists in your \JPCLI directory, it will be read and the serial port set correctly. It has the following format:
  315. Line 1:Baud rate (value between 1-16)
  316. Line 2:Parity (value between 0 and 2)
  317. Line 3:Data bits (5,6,7,8)
  318. Line 4:Stop bits (2,1)
  319. Line 5:Handshaking (11,4,7,0,3,12,15,8)
  320. For an explanation of the values, see your s3a programming manual, pages 237 and 238.
  321. * Semaphore files
  322.     JPcli can recognise the following files. If they are present in your \JPCLI directory, they will do something..
  323.     NOENV.SEM - Won't create environment dropfile
  324.     NOCACHE.SEM - Won't create the cache
  325.     NOBATT.SEM - Won't do initial battery checking
  326.     SMCACHE.SEM - Makes JPcli always use a small, 5k cache.
  327.     MDCACHE.SEM - Makes JPcli always use a medium, 10k cache.
  328.     LGCACHE.SEM - Makes JPcli always use a large, 20k cache.
  329. NOCACHE.SEM overrides the three other cache semaphores. If the relevant ??CACHE.SEM file exists then that cache will always be created, no matter how much memory is free.
  330. * File redirection/output
  331.     If you want to redirect output of a command (e.g. DIR, HELP, ENVINFO, etc.) to a file, there are two ways of doing it. Use a single > to create a file and a >> to append to the end of the file. ie:
  332. DIR *.APP >DIR.TXT
  333. Does a DIR *.APP but redirects all screen output to DIR.TXT. If DIR.TXT already exists it will be overwritten.
  334. DIR *.APP >>DIR.TXT
  335. Does a DIR *.APP but redirects all screen output to DIR.TXT. If that file exists then new data will be added to the end.
  336.     Redirection works with most commands, except <MORE> prompts aren't redirected so you can see what to do.
  337. * Error messages
  338.     Following is a description of some of the more.. freqent.. errors, and why they occur.
  339. Bad command or file name
  340.     This is when JPcli cannot find the command or filename you just entered. If you were trying to do a command, check your spelling. If you were trying to run a file, check the file exists, that ARIA is set to on if you are trying to run an internal app, and that the file is in the current directory or path.
  341. Invalid arguments
  342.     This is when you don't specify the right amount of arguments for a command, or specify a name when JPcli expects a number (and vce versa).
  343. In use
  344.     This is usually when you are trying to use the serial/parallel port when it's being used by another program.
  345. Insufficient Memory
  346.     JPcli does not have enough memory to continue the current command. Free up some memory and try again.
  347. End of file
  348.     This can happen when trying to view a single plane .PIC file with VPICG. Use VPIC to view single plane .PICs.
  349. File system not found
  350.     Usually when you unplug the PC cable.
  351. Font not loaded
  352.     You have not loaded the specified font. Check you got the right font number, and use LOADF to load the font into memory.
  353. File already exists
  354. File does not exist
  355. Directory does not exist
  356. File or device in use
  357. Invalid name
  358.     These are obvious. (!!)
  359. Record too large
  360.     Ths usually happens with TYPE. Make sure each line in your text file is less than 255 characters long and that the file is a text file.
  361. Access denied
  362.     This happens if you try to delete a file that is write protected. It also happens if you do not specify a correct filename for use with VFILE.
  363. Read only file
  364.     This happens usually when you try to change a file with VFILE that is in use. To edit the fie JPcli must be the only app using the file.
  365. Invalid volume/Media is corrupt/Unknown media
  366.     Your disk needs reformatting as it is corrupt. :(
  367. You shouldn't get any other errors, but if you do.. well.. e-mail me and say so.
  368. * The SET command
  369.     Using the set command, you can set a variety of JPcli defaults. To set a command, do the following:
  370. SET <command>=<value>
  371.     The following commands can be set:
  372. CHARSUB
  373.     1 - Sets Low-ASCII character substitution on
  374.     0 - Turns it off again
  375. DRVACD
  376.     1 - Turns on the "virtual drive access light"
  377.     0 - Turns it off again
  378. DIRCMD
  379.     4 - Sets default DIR format to /T
  380.     3 - Sets default DIR format to /G
  381.     2 - Sets default DIR format to two-column format
  382.     1 - Sets default DIR format to widescreen format
  383.     0 - Sets default DIR format to single column format
  384. RUNINT
  385.     0 - Turns off default running of internal apps
  386.     1 - Turns it on
  387. SETVOL
  388.     0-5 - Default volume for playing .WVE files
  389. * Batch Files
  390.     JPcli lets you run groups of commands together, in one batch, from a file. This file is called a batch file. An example batch file might consist of:
  391. @ECHO OFF
  392. CD \APP
  393.     Each command is executed, one after the other. The first command, @ECHO, has two parts to it. The @ means that the command itself will not be printed on the screen, and ECHO OFF makes sure no further commands are printed on the screen. This is the same:
  394. @CD \APP
  395. @CD \
  396.  If it sounds quite complicated, just try it for yourself. You'll soon find out. You can create batch files using the CFILE command, and make sure that the file has a .JPC extension. Either run it by typing RUNJPC (filename) or by just typing the filename.
  397.     A file called AUTOEXEC.JPC, if it exists in your LOC::M:\ directory, will be run each time JPcli is started.
  398. * External Help
  399.     If you have the external help version of JPcli, you can delete the JPCLI.HLP file, but then you won't be able to get complete help (only just a listing of commands)    
  400. * PC linking
  401.     If you have the 3-link, you can connect JPcli to a PC and use the PC drives as if they were on the s3a themselves. Make sure you turn the link on at both ends.
  402.     Due to the fact that Macs use a *completely* different filing system to the PC, JPcli can't be used with the Mac. Sorry. :( Large changes would be necessary before this would be an option.
  403. * Running External Applications
  404.     The RUNAPP command is the most powerful command in JPcli. With it, you can run any of the internal applications, and indeed any of your own programs, and specify your own file to use. The following internal programs can be run from JPcli (and they don't need to be installed on the system screen):
  405. Application            Appcode
  406. - Data                 DATA
  407. - Word                WORD
  408. - Agenda                AGENDA
  409. - World                WORLD
  410. - Calc                CALC
  411. - Sheet                SH3
  412. - Comms                COMMS
  413. - Record                RECORD
  414. - Script                SCRIPT
  415. - RunOpl                EXTAPP
  416. - APP and IMG files        APPIMG
  417. - Program                PROGRAM
  418. All but Calc require a filename to load or run - simply enter RUNAPP <appcode> <file>, so, for example, to load word with the file \WRD\JPCLI.WRD, simply enter (at the prompt):
  419. RUNAPP WORD \WRD\JPCLI.WRD
  420. If you want to run your own applications (.OPO, .OPA or .APP files), you can by entering the following (this example runs a file \APP\JPCLI.OPA)
  421. RUNAPP EXTAPP \APP\JPCLI.OPA
  422. It's all rather easy to use. (!!). So there are some shortcuts. If you just enter the name of the file (with no extension), JPcli will run it if it can find an application that will load it.
  423. JPcli searches the current directory and then each directory in the path (see the path section in this manual) for files matching that name. For example, if you are in the \WRD directory, and you type README, JPcli will search for README.*, and if it matches a valid extension then it will automatically run WORD with the file README.WRD (assuming the README file was a .WRD file!)
  424. However, if the file README.WVE existed in the \WRD directory or any of the path directories then it would automatically run record with file README.WVE. JPcli searches in the following order:
  425. - .JPC (JPcli batch file)
  426. - .OPA
  427. - .OPO (runs first procedure)
  428. - .APP
  429. - .IMG
  430. - .OPL
  431. - .WRD
  432. - .WVE
  433. - .AGN
  434. - .DBF
  435. - .SPR
  436. - .WLD
  437. - .SCR
  438. - .SCO
  439. (Make sure RUNINT is set to on, or this won't work! See the SET command for further info on RUNINT.)
  440. It's a lot easier than all that RUNAPP stuff!
  441. You can also run your own applications with their own data files - for example, if you want to load \APP\TYPE2.OPA with the file \APP\DATA.DAT, you can type:
  442. RUNAPP \APP\TYPE2.OPA \APP\DATA.DAT
  443. And JPcli will load it for you.
  444. Another useful thing you can do is directly specify the name of the file to load on the command line - so if you wanted to load \APP\TYPE2.OPA with the file \APP\DATA.DAT, you could just enter (at the command line)
  445. TYPE2 \APP\DATA.DAT
  446. Presuming that TYPE2.OPA was in the path or current directory.
  447. ** NEVER even THINK about trying to run an .IMG file using the extapp command - your s3a WILL (in most cases) reset **
  448. * The RUNEXT.DAT file
  449.     This file basically provides JPcli with a way of running files. If it exists in your \JPCLI\ directory, JPcli will read it and look at its contents. It is set up as follows: the first word per line is an extension and the second word is a file to run specifiying the file you first entered plus the first word... if you see what I mean. It's easier with an example. Say your RUNEXT.DAT file had the following:
  450. ; Lines starting with this are a comment and are ignored
  451. ZIP LOC::M:\APP\UNZIP.OPA
  452. (remember the space between ZIP and LOC...)
  453. Now, if you typed JPCLIZ, and the file JPCLIZ.ZIP was in the current directory/path, JPcli would run LOC:M:\APP\UNZIP.OPA specifying JPCLIZ.ZIP as the file to load.
  454. * The VFILE command
  455.     The VFILE command views a file, byte-by-byte. Press ESC or Ctrl-C to abort and return to the prompt at any time. To jump to a position in the file, press J, and you will be asked to enter a number. This is the offset you want to jump to - to move to byte number 4505, enter 4505 here, or -1 not to jump at all.
  456.     Press C to change a byte, enter the offset you want to change and then enter the new value (must be in the range 0-255, or -1 to abort the edit)
  457. * Encoding your data
  458.     The ENCODE word encodes any type of file using Rotary Unit Fixing - an extremely efficient system that, using two code keys, can encode in lots of different combinations. Simply encode a file by the following:
  459. ENCODE (file to encode) (file to write)
  460. and then enter your two encryption keys (both must be in a range of -255 to 255)
  461. Don't forget the two keys! There is no way of knowing which key was used, so without them, your encoded file is useless! Then, to decode your files:
  462. DECODE (file to decode) (file to write)
  463. and then enter your two keys again.
  464. * The JP environment variable
  465.     The JP environment variable provides external applications with a link to JPcli. It has the following info:
  466.  Command line and switches
  467.  Current path
  468.  Current drive
  469.  Current file system
  470.  JPcli's Process ID
  471. The commands are simply stored one after the other, separated by character code 174.
  472. Command line
  473. current path
  474. file system (LOC, ROM or REM)
  475. current drive (1 character)
  476. process ID
  477. The environment variable is deleted whenever you exit JPcli.
  478. * Updates
  479. v1.0        First version of JPcli. Very limited. Only two commands (DIR and SETDIR).
  480. v1.1        More commands added.
  481. v1.2        Even more commands added. More of a command line interface.
  482. v1.3        RUNAPP command added. Major bugs in DIR command revealed.
  483. v1.35     Encode command added. Now shareware. JPCOMMND.DAT.
  484. v1.39    DIR problems fixed. RUNAPP revised - now runs external apps.
  485. v1.4        Can run batch files and view text files and binary files. 
  486. v1.5        Most/all bugs now fixed. First public release. Able to run type 2 apps w.files.
  487. v1.6        Too many to list (but REM:: now works!!)
  488. v1.61    v1.6 updates reapplied after I lost the source code. :( JPCOMMND.DAT
  489.         removed - all one file.
  490. * Registration
  491.     Of course, like many other good quality programs, JPcli is shareware. That means that if you like it you have to register it after a thirty day period. After that, you must either delete it or register. Just 
  492. 15! The benefits of registering are just two things:
  493. - The delay at the start is removed, as is the messages that occasionally come up.
  494. - The quick exit system is enabled, letting you just press Psion-ESC to exit.
  495.     I don't really agree with some current shareware that is limited-until-registered, as you don't really get a good idea of what you are paying for. That's why shareware JPcli is as close to the registered JPcli as possible.
  496.     Of course, registering JPcli makes sure that brilliant programs like this are available (and written!) in the future. Not registering JPcli after 30 days is illegal!
  497.     This program is not public domain - I still hold the copyright to this program (and have proof) - so do not break the law by stealing this program (by leaving it unregistered for more that 30 days) or by passing it off as your own.
  498. You can send registrations, enclosing 
  499. 15 in UK sterling (cash or cheque) to:
  500. John Portwin
  501. Shareware Registrations Department
  502. Beechwood Farm
  503. Buckland Common
  504. Nr Tring
  505. Herts
  506. HP23 6PB
  507. ***    Make sure you enclose your name as you entered it when you first used JPcli - if the two differ then the registration key will be invalid!! ***
  508. * How to get your key: **
  509. For those of you with modems:
  510. 1) If you send me an e-mail address with your cash+name, I will uuencode your file
  511.     and return it to you.
  512. 2) If you send me a netmail address, I will uuencode you file and send it that way.
  513. 3) I can put the file 'on hold' at my BBS - a message will be sent to you with the password
  514.     required to access it.
  515. For those of you with mailers:
  516. 4) For 
  517. 1 extra (
  518. 2 outside UK), I will crash the file to your mailer (remember to enclose
  519.     hours that your mailer is up and your telephone no or fido netmail address). If I
  520.     cannot transfer the key in four tries:
  521. 5) I will put it on hold at my BBS' mailer (Fidonet 2:252/337, 01494758998) for you to
  522.      poll.
  523. For those of you without either:
  524. 6) I can send you the file on an SSD, but you must send an SAE with the SSD inside it.
  525. * Remember to specify which method you want to use!!! * 
  526. Whichever method you use, you will end up with a new JPCLI.OPA file. Copy that into your JPCLI directory and you're registered!
  527. * Contacting the author
  528. E-mail:    john@lyster.demon.co.uk
  529. Complaints: bin@lyster.demon.co.uk
  530. Netmail:    John Portwin @ 2:252/337
  531. BBS:        +44 (0) 1494758998 
  532.         Psychotic Mouse BBS, where everyone gets the latest in Psion files! It's
  533.         the home of the Psion mail network PsionNet! All users get access to E-mail
  534.         (with their own e-mail address) and Usenet newsgroups, like comp.sys.psion,
  535.         and comp.binaries.psion.
  536.         For more information about PMB, finger bbs@lyster.demon.co.uk or send a
  537.         blank e-mail to info@lyster.demon.co.uk.
  538.         (Cheap plug over)
  539. --- * ---
  540. JPcli is copyright John Portwin, 1995. Please do not modify and distribute, or try to pass this off as your own.    
  541. HANN*
  542. BTIIa
  543. BTNNM
  544. BTNN"
  545. BTNN/
  546. BTNNE
  547. BTNN 
  548. BTNN(
  549. BTNN!
  550. BTNN/
  551. BTNNE
  552. BTNN 
  553. BTNN.
  554. BTNNl
  555. BTNNm
  556. BTNN    
  557. BTNNg
  558. HBNNn
  559. BTNN!
  560. BTNN|
  561. HBNN'
  562. BTNN/
  563. HCNN<
  564. HCNN?
  565. HCNN 
  566. HCNNM
  567. HCNNP
  568. BTNN%
  569. HCNNV
  570. HCNN,
  571. BTNN!
  572. HCNNV
  573. BTNN'
  574. HCNN,
  575. HCNNS
  576. BTNN)
  577. HCNNQ
  578. BTNN%
  579. HCNN/
  580. HCNN?
  581. HCNNI
  582. HCNNU
  583. BTNN'
  584. HCNND
  585. HCNNU
  586. BTNN<
  587. HCNN"
  588. HCNN!
  589. HCNNO
  590. HCNNN
  591. HCNNO
  592. HCNN2
  593. HCNN5
  594. HCNN(
  595. HCNN7
  596. HCNN5
  597. HCNNH
  598. HCNNS
  599. BTNNP
  600. HCNNL
  601. HCNNQ
  602. BTNN/
  603. HCNN(
  604. BTNN    
  605. HCNNP
  606. BTNN'
  607. HCNN"
  608. BTNN'
  609. HCNN4
  610. HCNN6
  611. HCNN%
  612. HCNN(
  613. HCNN-
  614. HCNN,
  615. HCNN1
  616. HCNN/
  617. HCNNG
  618. HCNNN
  619. BTNN 
  620. HCNN?
  621. HCNNQ
  622. HCNNR
  623. HCNN1
  624. HCNN&
  625. BTNN$
  626. HCNNM
  627. HCNN#
  628. BTNN-
  629. HCNN%
  630. HCNN/
  631. HCNNG
  632. HCNN6
  633. HCNN.
  634. HCNN6
  635. HCNN(
  636. HCNN)
  637. HCNN!
  638. HCNN&
  639. HCNN'
  640. BTNN;
  641. BTNN_
  642. BTNN 
  643. BTNN9
  644. BTNN(
  645. BTNN 
  646. BTNN$
  647. BTNN-
  648. BTNNA
  649. BTNN%
  650. BTNN(
  651. BTNN 
  652. BTNN'
  653. BTNN'
  654. BTNN.
  655. BTNN;
  656. HBNN8
  657. HBNNS
  658. BTNN(
  659. BTNNz
  660. HBNNS
  661. BTNNf
  662. BTNN)
  663. BTNNS
  664. BTNN0
  665. HBNNy
  666. BTNNl
  667. HBNN8
  668. BTNN|
  669. BTNN&
  670. BTNN&
  671. BTNN(
  672. BTNNV
  673. HBNNq
  674. BTNN/
  675. BTNN&
  676. BTNN0
  677. BTNN9
  678. BTNN;
  679. BTNN:
  680. BTNNu
  681. BTBB/
  682. BTNNo
  683. BTNNy
  684. BTNNj
  685. HBNNX
  686. HCNN4
  687. HCNNn
  688. HCNNg
  689. HCNNo
  690. HCNN'
  691. HCNNz
  692. BTNN.
  693. HCNN3
  694. BTNNQ
  695. HBNNe
  696. BTNN$
  697. HCNN.
  698. HCNN/
  699. HCNN#
  700. BTNN#
  701. BTNN2
  702. BTNN2
  703. BTNN5
  704. HCNN0
  705. HCNN-
  706. BTNN    
  707. BTNNn
  708. BTNN 
  709. HBNN+
  710. BTNN~
  711. BTNNe
  712. BTNN.
  713. BTNN$
  714. BTNN 
  715. BTNN?
  716. BTNNw
  717. BTNN9
  718. BTNN,
  719. HBNN8
  720. BTNN(
  721. BTNNQ
  722. BTNN(
  723. BTNN$
  724. HBNNm
  725. BTNNU
  726. BTNN_
  727. BTNN=
  728. BTNNP
  729. BTNNB
  730. BTNN@
  731. BTNN:
  732. BTNNC
  733. BTNNA
  734. BTNNV
  735. BTNN/
  736. BTNNK
  737. BTNNS
  738. BTNNN
  739. BTNNN
  740. ZANN#
  741. ZANN    
  742. ZANN    
  743. BTNNS
  744. BTNNT
  745. BTNN\
  746. BTNN[
  747. BTNNV
  748. BTNN+
  749. BTNNW
  750. BTII!
  751. BTNNW
  752. BTNN9
  753. HBNN 
  754. BTNN#
  755. BTNN"
  756. BTNNK
  757. BTNNN
  758. BTNNN
  759. BTNNJ
  760. BTNN+
  761. ZANNq
  762.